Release 10.1A: OpenEdge Development:
Open Client Introduction and Programming

Open Client interface validation

The Open Client interface definition is reconciled against the actual r-code on the system, because the r-code can change independently of the saved Open Client interface definition. This process throws away obsolete information and picks up new information, while preserving customizations that are still valid with regard to these changes. This process generates an activity log (.log) file that records any significant validation events. This file is created in the output directory specified in the generation preferences.

When validation occurs

Open Client interface validation occurs when you do any of the following:

You choose File Generate from the ProxyGen menu bar or the Generate button from the toolbar.
You run Batch ProxyGen on the saved project file.
You customize a method or ProcObject definition (procedure or persistent procedure). Validation occurs only for the selected procedure.

How validation works

Open Client interface validation consists of the following:

Verifies the selected procedure files exist on disk, and if it does not, removes the procedure from the Open Client interface definition.
Compares any customizations made for procedures against the actual r-code and synchronizes them according to the following rules:
If a parameter for a procedure in the project file matches a parameter in the r-code by name and data type, any customizations for the parameter are maintained. Otherwise the parameter is assumed to be new, and the default setting is used to determine whether the client can use the parameter to pass an Unknown value (?). If you remove the parameter, it is removed from the interface.
If an internal procedure or user-defined function in the project file matches an internal procedure or user-defined function in the r-code by name and type (where type is whether it is a procedure or function), any customizations are maintained. Otherwise the internal procedure or user-defined function is assumed to be new, and it is assigned all default definition settings (method name, description, and so on).
Validates the method and parameter names and verifies all method names are unique within each Open Client interface object and parameter names are unique for each method.
Note: While you can override method names in ProxyGen, you cannot override parameter names.
Verifies all object names are unique within the Open Client interface.
Logs discrepancies, errors, and reconciliations to the activity log.